Inside Macintosh: QuickDraw GX Printing Extensions and Drivers /

Chapter 4 - Printing Messages / Printing Messages Reference

Printing Messages / Compatibility Messages

GXPrDlgMain

QuickDraw GX sends the GXPrDlgMain message when an application that supports
the Macintosh Printing Manager calls the PrDlgMain function. You can override the GXPrDlgMain message to customize the handling of the PrDlgMain function. Your override of the GXPrDlgMain message must match the following formal declaration:

OSErr MyPrDlgMain (THPrint aTHPrint, 
                     PDlgInitProcPtr aPDlgInitProcPtr,
                     Boolean *aBoolean);

aTHPrint

A handle to the print record for this printing operation.

aPDlgInitProcPtr

A pointer to the procedure used to initialize the Print dialog box.

aBoolean

On return, a Boolean value that is true if the user confirmed the dialog box and false if not.

function result

An error code. The value noErr indicates that the operation was successful.

DESCRIPTION

The default implementation of the GXPrDlgMain message sets up the default controls for the Print dialog box. You can override this message if you need to add any special handling to the processing of GXPrDlgMain calls by your printer driver.

SPECIAL CONSIDERATIONS

You never send the GXPrDlgMain message yourself.

You almost always forward the GXPrDlgMain message so that the default implementation can perform its operations.

RESULT CODES

gxSegmentLoadFailedErr	A required code segment could not be found, or there was not enough memory to load it.
gxPrUserAbortErr	The user has canceled printing.

SEE ALSO

The PrDlgMain function is described in Inside Macintosh: Imaging With QuickDraw.

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help